aiassisted documentation

Use the Model Context Protocol (MCP) to turn sprawling docs into live, terminal-ready operations. This guide gives distro-specific installs, a Bash toolbox (ripgrep, pandoc, markdownlint, MkDocs/Sphinx), a watcher, and mappings to expose search/convert/lint/build/changed as MCP tools—making docs verifiable, observable, portable, and CI-friendly without replacing your stack.

Learn to build self-documenting Bash scripts that never let docs drift: add a parseable '#%' header as the source of truth, wire it to --help, auto-generate man pages with help2man, and use AI (local via Ollama or cloud via llm) to refresh headers from code. Includes install steps, a gen-help tool, a pre-commit hook for format/lint/docs, and Make targets to keep help, man pages, and README in sync.